新人 技術 者 の た め の 


ク 


シス テム の 記事 叶 ビギナー ズ 


ここ で は 設計 書 を 作成 する 際 の ポイ ント に つい て 述べ る . 新人 
研修 な ど で は きち ん と 設計 書 を 作成 し て か ら コ ー デ ィング を 行 
う よ う に 指導 され る が , 実際 の 製品 開発 で は 設計 書 の 作成 が 軽 
視 さ れ て いた り , きち ん と 保守 され て いな い ケ ー ス が ある . 本 
稿 で は 設計 書 に 求め られ る 要件 に つい て 説明 する . また , 設計 
書 の 表現 形式 と し て , ブロ ッ ク 図 や フロ ー チ ャ ー ト を 利用 する 


際 の 問題 に つい て も 議論 する . (編集 部 ) 

C さ ん は ある 携帯 音楽 プレ ー ヤ の 開発 に 携わっ て いま す . 
携帯 音楽 プレ ー ヤ は , 最近 話題 の 人 気 商 品 で あり , 各 メ ー 
カカ は 開発 に し の ぎ を 削っ て いま す . そん な 中 , C さ ん も こ 
こ 1 年 ば か り ソ フト ウェ ア 開 発 に 奮闘 し て きま し た . 

「 仕様 が 定まら な い 」,「 開発 を 始め る と ハー ドウ ェ ア が 
動か な い 」,「 機能 ブロ ッ ク を 結合 する と , シス テム が ハン 
グ ア ッ プ し た り , 音 が 出 な く な っ た りす る 」 な ど , お 決ま 
り の トラ ブル を くぐり 抜け すてき た C さ ん に も , 開発 が ひと 
段落 し て , ホッ と ひと 息 つ く 時 間 が で きた よう で す . 

… と 思っ て いた ら , 上 司 か ら 以下 の よう な 要望 が 出 て き 
まし た .「 1 次 製品 の 開発 中 の バグ は , その 数 の 多 さ も さる 
こと な が ら , バグ が 報告 され て か ら 解 決する まで に 時 間 を 
費やし た こと が 問題 視 さ れ て いる . 2 次 製品 の 開発 に 向け 
て , 各 機 能 ブ ロッ ク の 担当 者 に は , 設計 レベ ル か ら の 見 直 
し が 必要 な の で は な いか 」. 

そこ で C さ ん は , 各 機 能 ブ ロッ ク の 担当 者 と 連絡 を と り , 
児 状 ,」 どの よう な 資料 が 残っ て いる の か を 調べ て も ら う こ 
に し まし た . そこ で 判明 し た の は , 携帯 音楽 プレ ー ヤ 3 
体 の 仕様 書 や , 各 機 能 を 最初 に 割り ふる 際 に 議論 し た 議 還 


ゆ 


組 | 


0 ヲ ロ ジャ ーー ド 。 ョ コー デ デ ィ ジグ 。 ツ ラド 必中 
ョ ーー イジ ター デラ ョ デー 


。 ア ダリ ケー ショ ジ 


> 入 


設計 書 ? 
仕様 書 な ら 
見 た こと ある けど ね 


※ 本 連載 記事 の 第 1 回 と 第 2 回 は , 本 誌 2006 年 6 月 号 , pp.50-59 の 特集 1 第 
4 装 いか に し て バグ の 原因 を 突き 止め る か 」, pp.60-66 の 特集 1 第 5 麗 プロ 
グラ ミン グ に お ける 良い デー タ 構造 と は 」 と し て 掲載 され まし た . 


録 の た ぐい は 残っ て いる の に , 設計 書 と 呼べ る も の が ほ と 
ん ど な い こと で し た .「 設計 書 ? 仕様 書 な ら 見 た こと ある 
けど ね 」 と , 別段 気 に も と め な い ツ ワ モ ノ も 数 多く いま し 
た . 一 部 の 機能 こつ いて は , コー ディ ング の 前 に フロ ー チ 
ャ ー ト を まとめ た 人 が いる と いう こと だ っ た の で , それ を 
見 せ て も らい まし た . し か し , その 中 身 は 現在 の 構成 と は 
か な り 異な る も の で し た . と いう の は , 途中 で 加え られ た 
2 の の 店 和 和 虹 0 お の ワコー 反映 SG 
いな か っ た の で す . 

C さ ん の 報告 を 聞い て 業 を 煮やし た 上 司 は , 次 の よう に 
断言 し まし た .「 2 次 開発 で は , 設計 段階 で , 各 機能 ブロ ッ 
ク の 担当 者 に 詳細 な 設計 書 の 提出 を 要求 する . それ ら の レ 
ビュ ー を 終了 し て か ら で な いと , コー ディ ング に 入る こと 
は まかり な らん 」. 

確か 設計 」 の 工程 は お 世辞 に も 充実 し て いた と は 言え 
ず , 設計 の 見 直し が 必要 と いう 上 司 の 指摘 は 正論 で ある に 
は 違い あり ませ ん . し か し , 問題 は それ に 必要 な 工数 で す . 
開発 対象 の 携帯 音楽 プレ ー ヤ は , 全体 で 数 十 万 ステ ッ プ の 
規模 を 持っ て いま し た . それ ら を 詳細 な む な フ ロー チャ ー ト に 
起こ し て レビ ュー し , し か る 後に コー ディ ング を 行い , 発 
生 し た バグ の 修正 や 仕様 変更 を 正確 に 反映 し よう と し た ら , 
どう 考え て も コー ディ ング に 必要 と 考え られ る 期間 の 2 倍 
程度 の 工数 を 上 乗せ し な いと 達成 で きま せん . 2 次 製品 の 
開発 に 用 意 さ れ た 期間 か らい っ て , これ は 不可 能 で す . 

詳細 な 設計 書 を 用意 し ろ と いっ て も 工数 的 に 難し いも の 
が ある , と C さ ん は お そる お そる 上 司 に 告げ ば まし た が , 上 
司 は さら な る 正論 で 追い 討ち を か け て きま し た .「 そ も そ 


ア 設 計 , デー タベース , 携帯 音楽 プレ ー ヤ , 
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e 設計 段階 で 問題 点 の 早期 発見 に 努め る こと 

* コ ー デ ィング と は , 設計 書 を 忠実 に 移し 変え る 作業 に ほか な ら な い 

e 名 人 芸 に 頼っ た コー ディ ング か ら は , 安定 し た ソフ ト ウェ ア は 生ま 
れ な い 


【 現実 】 
* ソ ー ス が 設計 書 で し ょ . や っ ぱし … 
e 納品 前 に 整え れ ば 客 は 黙ら せら れる さ 
e 最近 は ソー ス か ら ド キュ メン ト を 起こ す ツ ー ル が ある で し ょ 


図 1 設計 書 を めぐ る 理想 と 現実 の へ だ た り 

これ は 今 に 始ま っ た こと で は な い . ソフ ト ウェ ア 工 学 の た いて い の 本 に は 設 
計 段階 に お ける 作り 込み の 重要 性 が 強調 され て いる し , 企業 の 新人 研修 な ど 
で も ,「 いき な り ( キー ボー ド を ) 打つ な 」 と か な ら ず 言 われ る の だ が … 


も 設計 と いう 工程 が 必要 な の は , コー ディ ング する 前 に 問 
題 点 を 洗い 出し て し まう こと に ある . 理想 の コー ディ ング 
工程 と いう も の は , 設計 書 を 機械 的 に 移し 変え る 作業 に な 
る は ず だ . 新人 研修 で そん な こと を 言っ て いた の は お まえ 
自身 じゃ や な か っ た か ? お まえ に し て は 珍し くい いこ と を 言 
うな と 思っ て 聞い て いた の に , みず か ら 覆し て どう する 」. 

上 司 の 正論 を 実行 に 移す た め に , C さ ん に 可能 な 手立て 
と し て , どの よう な も の が ある の で し ょ う が 図 1). 


@⑯「 言 う は や すし , 行う は 難し 」 の 設計 書 作成 

C さ ん の よう に ,「 ソフ ト ウェ ア 設 計 」 の 工程 の た いせ つ 
さがわ か っ て いな が ら , いざ それ を 実行 に 移す と な る と , 
どの よう に 設計 書 を 作っ た ら いい の か と ま ど う 人 は 意外 に 
多い よう で す . 確か に 新人 研修 な ど で は , だ れ で も 設計 書 
を 書か され ます . そし て 教師 役 の 先輩 社員 か ら ,「 趣味 で 
プロ グラ ム を 書く の で は な い の だ か ら , 設計 書 抜き に いき 
な り コ ー デ ィング し な いこ と 」 と 言わ れ , フロ ー チ ャ ー ト 
を 詳細 に 書か され て か ら コ ー デ ィング させ られ る も の で す . 

し か し , 実際 に 配属 され て 実務 に 携わる よう に な る と , 
設計 書 」 と 呼ば れる ド キュ メン ト が 用 意 さ れる こと が 段 く 
ほど 少な いこ と に 気づき ます . と くに , C さ ん の 上 司 が 述 
べた 正論 の よう に , 設計 書 の 作成 が コー ディ ング の 前 に 行 
われ る , と いう の は それ ほど 多く あり ませ ん . 納品 の 前 に 
ド キュ メン ト 整理 の た め に 初め て 設計 書 を 起こし, コー デ 
ィング 開始 の 前 に 作っ た か の よう に 日 付 を 記入 し て 納品 し 
た 経験 の ある 人 が , 少な か ら ずい る と 思わ れ ま す . 

ここ で , 設計 書 が 作ら れ な い 理 由 の 典型 と し て , 以下 の 
よう な も の が あり ます . 
e 時 間 が な い 


- つ 


新人 技術 者 の た め の 


UML 


図 2 ソフ トウ ェ ア 設 計 の フォ ーー マット 

いにしえ か ら 数 ある ソフ ト ウェ ア 設 計 の フォ ー マ ッ ト . も の の 本 を 調べ る と , 
昔 か ら あ る フロ ー チ ャ ー ト か ら 最 近 の UML ま で , いろ いろ と ひな 型 ら し き 
も の が ある に は ある . し か し , いか な る シス テム に も 適応 可能 な 万 能 の フォ 
ー マ ッ ト は , 残念 な が ら な さそ うだ 


e 仕様 変更 が 入れ ば 作り 直し が 必要 
e 作っ て も だ れ も 見 な い 

と くに ,「 時 間 に 制 約 が あり , 作っ て いら れ な い 」 と いう 
の が , 理由 と し て も っ と も 多い よう で す . それ だ けが 理由 
な ら , 短 時 間 で 作成 で き て , 後 工程 の 土 全 と な りう る 設計 
書 の 表現 形式 フォ ー マ ッ ト ) が 決ま れ ば , 解決 する は ず で 
す . た だ し , 問題 は その 中 身 で し ょ う . 

和 失敗 し た プロ ジェ クト を 調べ て みる と ,「 ソフ ト ウェア 
設計 の 段階 の 検討 が 不 十分 だ っ た た め , 後 の テス ト 工程 で 
手 戻 り が 生じ た 」 と 言わ れる こと が よく あります. そし て , 
実際 に 設計 に 携わっ て いた 人 に 話 を 聞い て みる と , まち が 
いな く 上 に 挙げ た よう な 返答 が 得 ら れる も の で す . 設計 工 
程 の 重要 さ を 説 く 人 は 多い の で す が , 「 必要 な 設計 書 を い 
か に し て 作る か 」 と いう こと に つい て は , 答え に 鯛 す る ケ 
ー ス が 少な く あり ませ ん . 

設計 書 を 用 意 す る に あたっ て , これ ら の 障害 が ある こと 
は 無視 で きま せん . 確か に , 短 時 間 に 作成 で き て , 後 工程 
の 土台 と な りう る フォ ー マ ッ ト ( 図 2) が あれ ば ,「 時 間 が 
な く て 作れ な い 」 と いっ た 障害 は 克服 で きる で し ょ う . し 
か し , 設計 書 を 作る あう え で いち ば ん 考え な けれ ば な ら な い 
の は , そもそも | どの よう な 情報 が 設計 書 に 整理 され て い 
る べき か 」 と いう こと で は な いか と 筆者 は 思い ます . 設計 
書 に 必要 な 情報 が きち ん と 整理 され て いれ ば , フォ ー マ ッ 
ト は その と きど き で 選択 で きま す . 逆 に フォ ー マ ッ ト だ け 
を 決め て し まう と , 不慣れ な シス テム を 開発 する と き に 足 
元 を すく われ る こと に な りか ね ませ ん . 経験 値 が マイ ナス 
に 作用 する , と いう こと は どん な 場合 に も 起こ りえ ます . 


人 @ 設計 書 に 求め られ る 四 つ の 項目 
C さ ん た ち に 作っ て も ら え そう な 設計 書 を 考え る 前 に , 
まず ,「 チー ム 開 発 に お いて 必要 な 設計 書 に 求め られ る も 
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図 3 

設計 書 に 求め られ る も の と は 

設計 書 に 求め られ る も の を 挙げ て みた . 設計 
書 と いう か ら に は , 各 ブ ロッ ク の 機能 分 け , 機 
能 間 の 関係 イン ター フェ ー ス ), そし て それ 
ら の 全体 像 明らか に し た いと ころ 


の は 何 か ? 」 と いう こと か ら 考 えて み ま し ょ う ( 図 3). 
1) 機能 分 け を 明確 に する 設計 書 

まず , 設計 書 に 必要 な 情報 は , シス テム の 機能 分 けが い 

か に 行わ れ て いる か と いう こと で す . シス テム の 機能 分 け 
は , 必須 機能 の 整理 と と も に , 以下 の 作業 の 基礎 に も な り 
ます 。 
e 担当 分 け 
e 作業 量 や 予算 の 見 積もり 
e 実装 方 法 の 検討 

要求 仕様 を 満た す た め に どの よう な 機能 が 必要 か を 考え 
る こと で , 必然 的 に 機能 分 化 が な され , それ を 基礎 に 担当 
分 け や 作業 量 の 見 積もり が 行わ れる か ら で す . 実装 方 法 に 
つい て も , ハー ド ウェア と ソフ トウ ェ ア の どちら を 使う か 
の よう な 大 梓 の と ころ は , 最初 に 決め な けれ ば な り ま せん . 
携帯 音楽 プレ ビー ヤ の シス テム 構成 が いか に 複雑 で あっ て 
も , 顧客 が 求め て いる こと は シン プル で ,「 いつ で も どこ 
で も 音楽 が 手軽 に 楽し め る こと 」 に ほか な り ま せん . この 
こと の た め に , どの よう な 機能 ブロ ッ ク が 必要 か , と いう 
と ころ か ら 設 計 の 作業 は 始ま り ま す . 

すべ て の 機能 を 自分 で 作る の な ら 話 は 別 で す が , 実際 の 
製品 開発 で は 複数 の 部 品 を 複数 の 会 社 に 発注 し て 実現 する 
こと が 一 般 的 で す . 機能 分 化 が な され て いな いと , 開発 チ 
ー ム を 構成 する こと すら で きま せん . 開発 を と り ま と め る 
人 で あれ ば , 機能 ご と に 何人 月 の 工数 が 必要 か を 考え る 一 
方 で , これ まで いっ し ょ に 開発 し て きた 各 チ ー ム の リー ダ 
の 顔 を 思い 浮か べ , どこ の 会 社 の だ れ に 頼め ば きち ん と や 
っ て く れ そ うか も 考え る も の で す . 

例え ば , 楽曲 の デコ ー ダ は ソフ ト ウェ ア で 実現 する の か , 
それ と も 専用 ハー ド ウェ ア を 組み 込む の か , さら に それ は 
内 製 自社 開発 ) す る の か , IER intellectual property) コ ア 
を 外 の 会 社 か ら 購 入 す る の か . 楽曲 を 記憶 する 媒体 は ハー 
ド ・ デ ィ ス ク 装 置 な の か , それ と も フラ ッシュ ・ メ モリ な 
の か . こう いっ た こと は , 開発 の か な り 初期 の 段階 で 決め 
られ ます . 

ー つ の 開発 チー ム 内 に 限定 し て も , 機能 分 け の 作業 の 大 
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機能 分 け を 明確 に で きる こと 図 


設計 書 に 必要 な 情報 図 


トン ヽ = ーー 
2 全体 像 が 明らか に な る こと 図 
( 機能 の 明確 化 と デ ッ グ の し ゃ すき ) 肥 | 信 襲 ヒ イ ン ター フェ ー ス を 一 日 で ) 


枠 は 同じ で す . どの よう に サブ 機能 を 分 化し たら 自分 の 担 
当 ブ ロッ ク を 実現 で きる の か を 考え , 開発 する サブ ブロ ッ 
ク の 開発 規模 の 見 積もり と 実際 の 割り ふり を 考え ます . 
以上 の 説明 か ら , 設計 書 に 必要 な こと は , まず 機能 分 け 
の 明確 化 で ある と 言え ます . 
2) 機能 間 の イン ター フェ ー ス を 明確 に する 設計 書 
機能 分 け と 同時 に 検討 を 要する の が , 機能 と 機能 の 間 の 
関係 , つま り , それ ら の 間 で や り 取り され る デー タ に どの 
よう な も の が ある か で す . 機能 間 の イン ター フェ ー ス を 決 
め る うえ で 考え な けれ ば な ら な いこ と を 以下 に 挙げ て み ま 
した 

e 各 単体 機能 の デー タ ・ フ ロー 

e デ バッ グ の し や すさ 

e 単体 テス ト 項目 
機能 分 け を 行っ た ら , それ ら の 関係 が わか り や すく シン 
プル で ある こと が 大 事 で す . 複雑 に 絡み 合っ て いる と デバ 
ッ グ の 妨げ と な り , 機能 単体 の テス ト 項目 も 立て づら く な 
ます 。 

この こと を , 携帯 音楽 プレ ー ヤ の デー タベース と その 上 
位 ブ ロッ ク の 関係 を 倒 に と っ て 考え て み ま し ょ う . 例え ば 
楽曲 デー タ を 検索 する に は , 最低 限 , 楽曲 に 対応 する キー 
項目 が デー タベース に 必要 で す . ユー ザ が 楽曲 を 選ぶ 画面 
を 表示 する に は , キー か ら 検索 さ れ た 楽曲 名 な どの 情報 が 
ー タ ベー ス か ら ユ ー ザ ・ イ ンタ ー フ ェ ー ス まで 上 が っ て 
こ な け れ ば な り ま せん . 

そし て , ユー ザ が 楽曲 を 選ぶ と き に 必要 な 情報 は , ユー 
ザ が パソ コン か ら 楽曲 を 取り 込ん で 登録 し た と き に は す で 

デー タベース に 登録 され て いな いと いけ な い の で す . 
全 NNIMINNMNMN 
く 過程 で , デー タベース の テー ブル 仕様 は か な り 検討 が 進 
お む お は ず で す . そし て , デー タベース の 仕様 を 明らか に する 
うえ で 最初 か ら 重要 な 役割 を 果たす の は , デー タベース と 
上 人 9 本地 EURO) まる デー タ 8 どの まり まね の お 。 と 
いう こと で す . 
第 1 段階 で 機能 分 けが で きた ら , それ ら の 間 で どの よう な 


デー タ が や り 取り され な けれ ば な ら な いか を 考え て , 機能 
その も の を より 詳細 に 検討 し て いき ます . 機能 分 けが 済ん 
で 機能 間 の イン ター フェ ー ス が 完全 に 固 ま れ ば , 工程 を 一 
つ 進 め て , 各 機 能 の より 詳細 な 検討 に 入る こと が で きま す . 

送 に 言う と , 機能 間 の デー タ に 検討 も れ が あっ て , それ 
が 結合 テス ト の 段階 で 判明 する と , た い へ ん 影響 が 大 きく 
な る の で す . 例え ば , デー タ 登録 の と き に 必要 な デー タ が 
仕様 上 で 欠け て いた と いう 場合 を 考え て み ま し ょ う . この 
場合 は 最悪 で 。 パソ コン の アプ リケーション (ソフ トウ ェ 
ア ), ユー ザ ・ イ ンタ ー フ ェ ー ス ・ ア プリ ケー ショ ン ・ サ 
ー バ , デー タベース の すべ て に 変更 が 入っ て し まう こと に 
な り ま ポ ず 機能 分 け の 全体 像 に つい て は 後述 ). 

よく 言わ れる | 設計 段階 で の 検討 すれ 」 と いう の は , 実は 
その ほとん ど が , 機能 間 の デー タ に 検討 も れ が あっ た 場合 
な の で す . 

機能 間 の デー タ ・ イ ンタ ー フ ェ ー ス を 決め る うえ で も う 
ー つ 重要 な こと は , デバ ッ グ し や すい 構成 に する こと で す . 
シス テム 全体 を デバ ッ グ する と き に 重要 と な る の は , バグ 
の 原因 と な っ て いる 機能 ブロ ッ ク の 特定 で す . バグ の 原因 
を 特定 する た め に は , 機能 間 の イン ター フェ ー ス の デー 
タ ・ フ ロー を ファ イル に し て 取り 出し た り , ロジ ッ ク ・ ア 
WAR 

送 に 言う と ,「 デバ ッ グ し や すく する に は , どう いう イ 
ンタ ー フ ェ ー ス に し て お け ば よい の だ ろう 」 と いう こと を , 
設計 の 段階 か ら 考 えて お くべ き で す . 機能 間 の デー タ ・ イ 
ンタ ー フ ェ ー ス は , いわ ば バグ を 捕らえ る た め の 落と し 
穴 」 と 言え まず 図 4). 

デバ ッ グ の た め の 落と し 穴 」 と し て の 機能 間 の イン ター 
フェ ー ス は , テス ト 工程 の 側 か ら 見 る と , 取り も 直さ ず 各 
機能 ブロ ッ ク の 単体 テス ト 項目 の 基礎 と な り ま す . と いう 

の は , 機能 問 の イン ター フェ ー ス の 動作 が 確実 に 保証 され 
た 段階 で 結合 テス ト が 可能 と な る た め , 機能 間 の イン ター 
フェ ー ス が 設計 仕様 を 満た し て いる か どう か を 確認 する こ 
と が 単体 テス ト の 目標 と な る か ら で す . 単体 機能 の 確認 が 
完了 し た ら 後 工程 の 結合 テス ト を 確実 に 行え る よう に , 設 
計 の 段階 か らく ふう され て いな けれ ば な り ま せん . 

し た が っ て ,「 テス ト し や すく 設計 する 」 の も 重要 な ポイ 
ント と な り ま す . デバ ッ グ の ポイ ント は , テス ト 項目 の 裏 
返し で も ある の で す . 

3) 全体 像 を 明らか に する 設計 書 

機能 分 け と 機能 間 の デー タ が 決ま れ ば , 


設計 書 を 見 た と 


新人 技術 者 の た め の 


ロジ カル ・ シ ン キ ング 人 


| | つ 


図 4 イン ター フェ ー ス は デバ ッ グ 時 の 落と し 穴 」 を 考え て 
ソフ ト ウェア を 設計 する 際 に ,「 どう 作れ ば デバ ッ グ し や すい か 」 を 考え て 設 
計 す る こと が 大 事 . 例え ば , デバ ッ グ の た め の ビ ルド を 行う と , ログ が 吐き 
出さ れ , た いて い の バ グ を 検出 で きる よう な 機能 を 組み 込ん で お く 


き に その シス テム の 全体 像 が 明らか に な っ て きま す . 設 
書 に 書か れ た 機能 と その 間 の イン ター フェ ー ス か ら 読む 人 
に 伝わる こと は , 結局 , 全体 の イメ ー ジ で す . 

シス テム 全体 の 設計 書 で あれ ば , 読む 人 が その 全体 像 を 
明確 に と ら え られ る よう に な っ て いな けれ ば な り ま せん . 
サブ シス テム の 設計 書 な ら , その サブ シス テム の 機能 分 け 
や 機能 問 の イン ター フェ ー ス , お よび ほか の サブ シス テム 
と の イン ター フェ ー ス が 全体 像 と し て 明らか に な っ て いな 
けれ ば な り ま せん . 

で すか ら 「 設計 書 」 と 呼ば れる も の は , 人 間 が ぱっ と 見 て 
わか る よう に , 1 枚 に まとまっ て 記述 され て いる こと が 望 
まし いと 言え ます . 設計 書 を ば っ と 見 た と き に 全体 構成 が 
明らか で , 機能 分 け と 機能 間 の イン ター フェ ー ス に 矛盾 が 
見 つか ら な く な れ ば , その 設計 書 は 完成 し た と 言っ て よい 
で し ょ う . 


@ ブロ ッ ク 図 で シス テム の 全体 像 を 記述 する 
以上 の よう な 設計 書 に 対す る 要求 を 満た し て くれ る フォ 
ー マ ッ ト の 例 と し て , ここ で は ハー ド ウェ ア の 外部 設計 な 
ど で も 用 いら れる | ブロ ッ ク 図 」 を 考え て み ま す . 

図 5 に 示し た の は , 携帯 音楽 プレ ー ヤ 全体 の ブロ ッ ク 図 
で す . ユー ザ は , USB ケ ー ブ ル を 介し て 端 来 プレ ー ヤ ) を 
パソ コン と つなぎ , 自分 の 好き な 楽曲 デー タ を 取り 込み , 
端末 内 に 保存 し ます . そし て 好き な と き に それ ら を 検索 し 
て 聴き ます . この 一 連 の 操作 を 実現 する た め の 各 機能 と そ 
の 関係 の 概略 図 で す . も ちろ ん , この レベ ル の 記述 は まだ 
概略 に すぎ ず , 実際 に 作る と な る と , も っ と いろ いろ と 考 
えな けれ ば な ら な いこ と が 出 て くる で し ょ う . 

全体 像 が 決ま っ た ら , 次 に 個別 の ブロ ッ ク を ブレ ー ク ダ 
ウン し て み ま し ょ う . 例え ば , 図 5 で さり げ な く ( ?) ア 
プリ ケー ショ ン ・ サ ー バ 」 と 書い た 機能 ブロ ッ ク は , 実際 
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アプ リケーション ・ チ ッ プ 図 
キー ボー ド 較 | LCR 液晶 ディ スプ レイ ) 隊 


組み 込み OS 


に 
つ 


ャ 


図 5 

携帯 音楽 プレ ー ヤ の 全体 
ブロ ッ ク 図 

お お ま か に 機能 分 け を 行い , 
機能 間 の イン ター フェ ー ス を 
整理 する . まず 全体 像 を 明 ら 
か に し , 次 いで , 細部 の ブ 


稚 帯 音楽 プレ ー ヤ 本 体 較 


専用 チッ プ 較 


ヘッ ド ホ ン 端 子 財 


ー ザ ・ インター フェー ス 図 


エン コー ド * 還 リ アル タイ ム OsS 
デー タ 図 


凶 ( ヾ 』 マ ー す て NSF) マロ で 


レー クダ ウン を 行う . 各 機 能 
の すみ 分 けが 明らか に な り , 
機能 間 の イン ター フェ ー ス が 
整理 され れ ば , 各 機能 単体 の 
検討 に 移る 


に は いく つか の 諸 機能 か ら な っ て いる は ず で す . お お ま か 
に 分 けれ ば , 登録 タス ク , 検索 タス ク , 演奏 タス ク の 三 つ 
の 機能 が 必要 で す . 
で は , それ ら の 間 の シー ケン ス は どう 記述 する の で し ょ 
う . 例え ば , USB ケ ー ブ ル で 接続 し て パソ コン 側 の アプ リ 
ケー ショ ン を 立ち 上 げ る と , 端末 側 で は 自動 的 に 登録 タス 
ク が 立ち 上 が る よう に し た いけ れ ど も , その と き 演 奏 中 で 
あっ た ら ど うす る か , な ど と いっ た 仕様 を 詰め る 場合 , 全 
体 の ブロ ッ ク 図 だ け で は と う て い 追い つか な いで し ょ う . 
全体 の 設計 図 か ら 一 歩 進 ん で , アプ リケーション ・ サ ー バ 
内 部 の 仕様 を 決め る 設計 書 を 別に 起こ す 必 要 が あり ます . 
ブロ ッ ク 図 を 作成 する 際 に と くに 注意 が 必要 な の は , 機 


アプ リケーション ・ チ ッ プ 図 専用 チッ プ 図 
1 『1 
D- ム 変換 較 


リア ル タ イ ム OS 


共有 メモ リ 領域 貫 


図 6 デコ ー ダ 機能 単体 の ブロ ッ ク 図 

デコ ー ダ で ある か ら に は , 当然 , デコ ー ド ・ アルゴリズム を 内 包 し て お り , 
こ の 部 分 の 設計 と テス ト は も っ と も 重要 . た だ し , 周り の ハー ド ウェア 回 路 
制御 を 作り 込む 工数 を 過少 に 見 積もっ て は な ら な い 
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能 間 の イン ター フェ ー ス , すなわち 機能 ブロ ッ ク 間 を つ な 
ぐ 信号 線 で す . ソフ ト ウェ ア の 設計 理論 で は , よく 「 モジ 
ュー ル の 独立 性 が 高い こと が 望ま し い 」 と 言わ れ ま す . こ 
れ は ,「 モジ ュー ル 強 度 が 強く , モジ ュー ル 結 合 度 の 弱い 
モジ ュー ル は 独立 性 が 高い 」 と いう , わか っ た よう な わか 
ら な いよ うな 議論 で す . 

が , この 説明 も , ブロ ッ ク 図 を 書い て みれ ば 一 目 瞭 然 で 
す . な ぜ な ら , 「 独立 性 が 強い 」 と いう こと は , 機能 問 の デ 
ー タ ・ イ ンタ ー フ ェ ー ス が すっ きり と 整理 され て いて , 各 
機能 の すみ 分 けが は っ きり し て いる こと だ か ら で す . 逆 に , 
検討 も れ の ある 設計 で あれ ば , ブロ ッ ク の 間 の 信号 線 が こ 
ん が ら が っ て いて , ブロ ッ ク の 間 の 分 担 が わか り に くく , 
検討 の 余地 が 残っ て いる こと に な り ま す . 


人 @ 機能 ブロ ッ ク 単 体 の ブロ ッ ク 図 を 作成 する 

各 機能 ブロ ッ ク の 担当 者 は , 全体 ブロ ッ ク が ある 程度 整 
理 され た 後 で , 各 機 能 ブ ロッ ク の 設計 に 入り ます . 試し に 
デコ ー ド ・ ブ ロッ ク に つい て , 単体 の ブロ ッ ク 図 を 描い て 
み ま し だ 図 6). 

エン コー ド さ れ た デー タ は , アプ リケーション ・ チ ッ プ 
と 専用 チッ プ の 間 の 共有 メモ リ 空間 に 配置 する こと に し ま 
す . 全体 の ブロ ッ ク 図 で は 記述 され て いま せん で し た が , 
デコ ー ダ で デコ ー ド され た デー タ は シリ アル 通信 回 路 と 同 
期 さ せ た DMA direct memory access) を 使っ て D-A 変 
換 器 に つなぎ , ヘッ ド ホン か ら 出 力 す る こと に し ます . 
DMA は デコ ー ダ の フレ ー ム レー ト に 合わ せ た 周 期 で 割り 
込み を か ける よう に し て , その 割り 込み ハン ドラ か ら デ コ 


ー ダ が 呼ば れ て 楽曲 デー タ を 処理 する し くみ に し ます . 
この よう に 整理 し て くる と , デコ ー ダ ・ ブ ロッ ク の 設計 

お よび テス ト の 工程 は , 大 ざっ ぱに 以下 の 二 つ の 作業 に 分 

か れる こと が 明らか に な り ま す . 

1) デコ ー ダ ・ モ ジュ ー ル 単体 の 設計 や コー ディ ング , テ 
スト 

2) デコ ー ダ ・ モ ジュ ー ル を リ アルタイ ム に 駆動 する た め の 

周り の 部 分 の 設計 や コー ディ ング , テス ト 

も ちろ ん , も っ と も 工数 を 要する の は , デコ ー ダ ・ モジ 
ュー ル そ の も の の 設計 や テス ト で ある こと は まち が いあ り 
ませ ん . リア ル タ イ ム 性 が 厳し く 求め らち れる デコ ー ド ・ モ 
ジュ ー ル を 実現 する に は , 最適 化 設 計 の ノウ ハウ を 反映 し 
な けれ ば な り ま せん し , 楽曲 の デコ ー ダ と し て 満足 で きる 
品質 を 保証 する た め に は , これ また 専門 性 の 高い テス ト 技 
術 が 要求 され ます . 

し か し その 一 方 で , デコ ー ダ を 動か す 周 り の 部 分 を 組み 
立て る 工数 を 過少 に 見 積もっ て し まう と , や けど する こと 
に な る で し ょ う . 組み 込み ソフ トウ ェ ア の 開発 環境 と いう 
の は , デバ ッ グ その も の より も , 実は 環境 の 立ち 上 げに か 
な り の 時 間 が 必要 で す . と くに , いろ いろ な ハー ド ウェア 
や ソフ ト ウェ ア が 複雑 に 絡む ブロ ッ ク の 結合 お よび 結合 テ 
スト は , ソー ス ・ コ ー ド の ステ ッ プ 数 か ら 想像 する より も 
工数 が か か る の が 一 般 的 で す . 


⑯ ブロ ッ ク 図 作成 の 所 要 時 間 は 比較 的 少な い 

ブロ ッ ク 図 を 用 いた 設計 書 を 作成 する 利点 と し て , その 
ほか に 挙げ られ る も の が ある と し た ら , 作成 に か か る 時 間 
が 比較 的 少な いこ と だ と 思い ます . 

ブロ ッ ク 図 は , 全体 像 を 明らか に する こと に 主眼 が 置か 
れ て いま す . 詳細 は 省略 し , と りあ え ず 全体 像 1 枚 を 起こ 
せ ば 事足り ます . 

例え ば 筆者 の 場合 , 設計 書 が ほとん ど 用 意 さ れ て いな い 
ソー ス ・ コ ー ド を 引き 継ぐ と き が 時 々 あります. その よう 
な と き は , と りあ え ず 前 任 者 に お 願い し て , 最低 限 , ハー 


利点 図 欠点 図 
* データ を 記述 で き な い 図 


* 処理 の 順序 ・ 分 岐 条 件 が 図 


整理 で きる 図 e 機能 問 の 関係 が 検討 で き ない 


図 7 フロ ー チ ャ ー ト の 特徴 


新人 技術 者 の た め の 


ドウ ェ ア と ソフ ト ウェ ア の 構成 が わか る よう な ブロ ッ ク 図 
を 機能 ブロ ッ ク ご と に 作成 し て も らい ます . 経験 的 に 言っ 
て , それ だ け で あれ ば , た いて い の 場 合 は すぐ に 用 意 し て 
も ら え ます . また , 全体 像 さえ 明らか に な れ ば , 詳細 は ソ 
ー ス ・ コ ー ド を た どっ て 何と か や りく りす る 体制 が 作れ る 
も の で す . 


@ フロ ー チ ャ ー ト は 解決 策 に な る か ? 

ここ まで , ブロ ッ ク 図 を 用 いた 設計 の 概要 を 説明 し て き 
まし た . 次 に ,「 設計 書 」 と いう と た いて い の 人 が 思い 浮か 
べ る で あろ う フ ロー チャ ー ト に つい て 考え て みる こと に し 
まし ょ う ( 図 7). フロ ー チ ャ ー ト は , 冒頭 の C さ ん の よう 
な 状況 に 置か れ た 人 に 解決 策 を 与え て くれ る の で し ょ う 
か ? 

まず 試し に ,「 1 か ら 10 ま で の 整数 を 順番 に 足す プロ グ 
ラム 」 と いう も の を 想定 し て , フロ ー チ ャ ー ト を 作成 し て 
9 と な も まし よう 。 

フロ ー チ ャ ー ト は 図 8 の よう な も の に な る で し ょ う .「 刀 
に 答え の 55」 が 入る よう に な っ て いれ ば 正解 で す . ここ で 
注意 し て いた だ きた い の は , フロ ー チ ャ ー ト を 使う こと に 
よっ て 整理 され た プロ グラ ム 上 の 情報 は 何かと いう こと で 
す . 図 を 見 る と それ は , 処理 の 順序 と 分 岐 の 条件 だ け で す . 
実際 , 商用 プロ グラ ム の コー ディ ング で ここ まで 単純 な 
も の を 書か され る こと は , まず あり ませ ん . し か し , どん 
な に 複雑 な プロ グラ ム で あっ て も , フロ ー チ ャ ー ト が 整理 
し て く れる 情報 の 内 容 が 変わ る わけ で は あり ませ ん . つま 
り , フロ ー チ ャ ー ト は どの よう な プロ グラ ム に 適用 し て も , 
処理 の 順序 と 分 岐 の 条件 を 整理 し て くれ る だ け な の で す . 


1 か ら 10 ま で の 足し 算 の フロ ー 


処理 の 順序 と 分 岐 の 条件 し か 整理 で き て い 
な い の に 注目 . この 程度 の アル ゴリ ズム の 
実装 に フロ ー チ ャ ー ト を 書き 起こ すこ と は 局 
実務 で は まず な い が , 整理 で きる 事 が ら は 
どん な アル ゴリ ズム に 適用 し て も 順序 と 分 
岐 の み 1 


設計 書 と いう と フロ ー チ ャ ー ト を 思い 浮か べ る 人 は 多い が , 利点 と 欠点 を 見 極め て 使う 必要 が ある . 本 稿 の 結論 Ma 
を 述べ る と , 狭い 範囲 の 論理 を 検討 する ツー ル と し て の 利用 に と ど め る の が 無難 . 上 ・ 中 流 の ソフ ト ウェ ア 設 計 End 


の 工程 に は 向 か な いと 筆者 は 考え て いる 
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携帯 音楽 プレ ー ヤ 図 
CD プレ ー ヤ 図 
図 
図 9 ユー ザ が 製品 に 求め る 機能 に 着目 
ユー ザ が 製品 に 求め る 機能 を ユー ザ の 目的 関数 」 と 考え る と , 各 関数 」 の 


作り は 製品 ご ど と に 異な る だ ろう . ユー ザ か ら 見 る と 似 た よう が 目的 関数 」 で 
も , 作り 手 か ら 見 る と どう 違う の か を , 設計 レベ ル で 検討 する 必要 が ある 


音楽 を 楽し むための 図 
家電 製品 凶 


で すか ら , 図 8 で 表せ な か っ た 情報 は , も っ と 大 き な プ 
ログ ラム の 場合 に も 整理 で き な い で し ょ う . 例え ば , ブロ 
ッ ク 図 で 重要 な 役割 を 果たし て いた 機能 ブロ ッ ク 間 の イン 
ター フェ ー ス の 整理 に ., フロ ー チ ャ ー ト は 向き ませ ん . フ 
ロー チャ ー ト は , 機能 ブロ ッ ク の 間 の デー タ の 流れ を 整理 
する こと が で き な い か ら で す . 

必然 的 に フロ ー チ ャ ー ト は , 狭い 範囲 の 処理 を 整理 する 
と き に の み 使 われ る こと に な り ま す . 複数 の 機能 ブロ ッ ク 
の 間 の 関係 を 整理 し て , 機能 分 け と その 間 の 信号 線 を 整理 
する と いう 上 ・ 中 流 の ソフ ト ウェ ア 設 計 の 工程 で は あま り 
使わ れ ま せん . 

た いて い の 人 に と っ て は , フロ ー チ ャ ー ト は 新人 研修 の 
と き に 書か され た きり で , 実際 の 開発 で 目 に する こと は 少 
な いと 思い ます . その 理由 は , フロ ー チ ャ ー ト の 利点 を 生 
か せる 機会 が あま りな いか ら だ と 筆者 は 思い ます . 


@ フロ ー チ ャ ー ト 作成 に は C 記 述 と 同等 の 時 間 が か か る 

また , フロ ー チ ャ ー ト に は , 記述 する の に と て も 時 間 が 
か か る と いう 欠点 も あり ます . 

プロ フェ ッ シ ョ ナル と し て し ご と を し て いる た いて い の 
プロ グラ マ な ら , 図 8 の フロ ー チ ャ ー ト を 描く の と 同じ く 
らい の 時 間 で ,「 1 か ら 10 ま で の 整数 を 順番 に 足す プロ グ 
ラム 」 を 言語 な ど で 記述 で きる こと で し ょ う . と いう こ 
と は , 例え ば 1000 ス テッ プ の プロ グラ ム の フロ ー チ ャ ー 
ト を 描く に は , それ を 書い た の と 同じ くら い の 時 間 を 要 す 
る と 考え た ほう が よさ そう で す . そこ まで し た と ころ で , 
フロ ー チ ャ ー ト が 整理 し て くれ る の は , 処理 の 順序 と 分岐 
だ け で す . 商用 開発 で 作ら れる よう な 規模 の プロ グラ ム の 
全 ソ ー ス ・ コ ー ド に 対し て ,「 詳細 が か フロー チャ ー ト を 
いて か ら プ ログ ラム を 起こ す 」 と いう の は か な り 無理 が あ 


川 上 
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る と 思い ます . 


⑯ ブロ ッ ク 図 に よる 表現 が 向く も の と 向 か な いも の が ある 

この 記事 を 読ん で ,「 自分 が 開発 し て いる シス テム で も 
設計 に ブロ ッ ク 図 を 使う と いい か も し れ な い 」 と 思っ た 方 
は いま すか ? その よう な あり が た い 方 に は , 自分 が 実際 に 
開発 し て いる シス テム と 似 た 構成 の シス テム を 雑誌 の 記事 
な ど で 探 し て , ブロ ッ ク 図 を 起こ し て みて いた だ きた いと 
思い ます . 例え ば , ゲー ム 専 用 機 を 作っ て いる 人 な ら , そ 
れ を も し 携帯 電話 に 乗せ る と し た ら , どの よう な 構成 に な 
る の か , 既存 の 携帯 電話 に 何 を 新た に 追加 し て , 何 を あき 
ら め る と 性 能 の いい ゲー ム ・ ケ ー タ イ ” に な る の か を 考え 
る な ど し て み ま し ょ 2 図 9). 

そし て , 具体 的 に その 全体 構成 を 考え た ら , 自分 の 担当 
する 機能 ブロ ッ ク の 詳細 を 掘り 下げ て み ま す . そう し た 後 
で , 実際 に 出荷 され て いる 製品 の 構成 と 比べ れ ば , 自分 の 
見 通し が まち が っ て いた , ある い は 古 す ぎ た と いっ た こと 
が 判断 で きた り , 新しい 製品 開発 の きっ か けが 見 い だ せ る 
か も し れ ま せん . そう な れ ば , ブロ ッ ク 図 を あな た が 手 が 
け て いる 実際 の 開発 で 使っ て みる の も いい で し ょ う . 

送 に , ブロ ッ ク 図 を 作成 し て みた と ころ , ふだん 自分 が 
使っ て いる 設計 手法 を 補う よう な も の は 得 ら れず , 肝心 の 
情報 が 欠落 し て し まう よう な 印象 を 持つ こと が ある か も し 
れ ま せん . この 場合 は , あな た の 開発 し て いる シス テム は , 
ブロ ッ ク 図 を 設計 書 に 採用 する の に は 向 か な い の で , 導入 
は あき ら め た ほう が いい か も し われ ませ ん . 

シス テム 開発 の いい と ころ は , く ふ ぶ う を すれ ば いろ いろ 
な こと が 自分 の 手 の 届く 範囲 で 手軽 に 試せ る こと で ある と 
筆者 は 考え て いま す . 大 規模 シス テム の 開発 が 相手 で も , 
く ふ うし だ いで 開発 手法 を 思考 実験 や 比較 的 簡単 な テス 
ト ・ プ ログ ラム の レベ ル に 落と し 込ん で 試し て みる こと が 
で きま す . この よう に , まず 小さ め の 開 発 サ イク ル を 回 し 
て みる , と いう アプ ロー チ は , ソフ ト ウェ ア 開 発 に お いて 

けっ こう 使い で の ある や り か た な の で す . 


さえ き ・ はじめ 


筆者 プロ フィ ー ル ツ 

沈 木 元 . シス テム ・ エン ジニ ア . 昔 か ら 実 は 語学 マニ ア . 今 ま で マス 
タ し そこ ね た 言語 は 数 知れ ず . プロ グラ ム 言 語 な ら な ん と か な る の だ 
が …. 大 学 時 代 は 英 仏 独 の 文献 が 読め る よう に な れれ ば いい な と 思っ 
て いた が , この 調子 だ と ライ フワ ー ク に な る か も し れ な い . 


